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Feeling midiSynful 

by Dennis Doms 

The synthLab software that comes with System 6 for the Apple IIqs 
gives you an environment for experimenting with creating music 
based on sampled sounds. The problem we'll look at this month is 
that the stock Apple IIqs does not include a musical input device. The 
solution is to connect a separate device designed for that purpose. 

IIqs users are familiar with the standard ways of connecting devices 
to their computers. The standard lies keyboard and mouse connect 
through the Apple Desktop Bus. The Macintosh also uses this bus; 
Macintosh and Has keyboards can be used interchangeably on the two 
systems. 

Since computer users may not buy all peripherals from the 
same manufacturer, there has been an impetus to create general 
standards that apply across different brands of products. Tor 

example, modems and printers can be connected through serial 
ports, which adhere to technical standards that insure that the 
devices will be electronically compatible and able to communicate at 
some basic level. Connecting a modem or printer may not guarantee 
that all of the features of the device can be used (that's up to the con- 
trolling software) but there is at least some expectation that a modem 
that adheres reasonably to the serial standard will work if the software 
knows how to command it. 

Several years ago the music industry was faced with a similar 
dilemma; computer technology was being integrated into devices not 
only as a means of sound creation but also as a means of controlling 
most of the features of the instrument. Eventually it became clear that 
it would be advantageous to use the capabilities of one instrument, or 
even a separate "non-musical" device, to control other instruments. 
The standard that emerged was a combination of hardware and soft- 
ware protocols called MIDI (for Musical Instrument Digital Interface). 

The MIDI hardware involves cabling that uses DIN-5 connec- 
tors (similar to the connector used on the lie, but wired differ- 
ently). The designated maximum length of a cable is fifty feet. The 
cable is shielded, with a twisted pair of wires inside. Fins 1 and 3 on 
the Diri-5 are not connected; pin 2 is the shield ground, pin 5 is the 
signal, and pin 4 is +5 volts. 

The cables are run between interfaces that consist of some combi- 
nation of "In", "Out", and "Thru" ports. The "In" and "Out" ports are 
the signal input and output ports respectively; MIDI "Thru", if present, 
duplicates the input signal on its output (it's essentially a "splitter" to 
provide a copy of the input signal). Devices commonly supply at least 
MIDI "In" and "Out" to guarantee two-way communication. There are 
external connection boxes that will split out a "Thru" signal if your 
devices don't have one. 

The interface communicates asynchronously at 31,250 baud 
(31.25 kilobaud, plus or minus one percent) with an eight-bit data 
word, one start bit, and one stop bit. This is not a mode supported 
directly by the 6551 serial interface adapter chip used in the 11c or 



Super Serial Card, though there have been external MIDI adapters for 
the lie (one from Passport Designs) and an internal MIDI interface for 
the He (also from PassFort). You may see these interfaces described 
as "6850 cards", which refers to their use of a 6850 interface adapter 
chip. 

The llQs and Macintosh use a different serial communications chip 
(the Zilog 8350) which can be adapted to MIDI though an inexpensive 
external interface. Apple's model is $99 retail; third-party adapters 
like those from Opcode or Alltech can be found discounted under 
$50. Apple's unit includes MIDI cables; the Opcode unit I bought 
doesn't. I made a couple of cables from some shielded twisted-pair 
microphone cable and a couple of Din connectors I picked up at 
Radio Shack for about $12. By way of compensation, the Opcode 
adapter does have one MIDI in and three MIDI out ports; the Apple 
interface has only one of each. 

In addition, the llos System Software includes support for a slot- 
based (lie-style) MIDI interface. Applied Engineering's slot-based 
Audio Animator also incorporates a MIDI interface. If you're interest- 
ed, some samples of MIDI hardware circuits are shown in Hal Cham- 
beriin's Musical Applications of Microprocessors. 

The complete MIDI specification (hardware and software) is avail- 
able through the International MIDI Association, 8426 Vine Valley 
Drive, Sun Valley, Calif. 91352, 213-768-7448. The current specifica- 
tion is. Since the hardware is basically just a means to facilitate the 
communication, the software protocol is usually the focus of MIDI dis- 
cussions. Many MIDI devices are available and the number of features 
they implement vary widely. This makes talking in specifics hard, so 
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we'll look at the elements of the protocol first and then how they 
apply to synthLab and MIDI Synth, 

A MIDI message consists of a status byte followed by zero or more 
data bytes. Status and data bytes can be differentiated; status bytes 
always have the high-order bit set and data bytes have it clear. That 
limits data values to the range 0-1 27 (or -64 to +63 depending on the 
interpretation), so expect to see many parameters limited to those 
ranges. If more resolution is needed, more data bytes can be used. By 
using the high-order bit specifically to identify status and data bytes, 
MIDI prevents the confusion of commands with data and should be 
able to recover somewhat if a byte is "lost" in transmission. 

The messages sent over MIDI are divided into two general 
types: system and channel. System messages send information 
between devices on the MIDI bus. Of these, there are three subcate- 
gories: common messages meant for all connected units; real-time 
messages, also meant for all units, which consist only of status bytes 
that individual devices can act on or ignore (since these don't use 
data bytes, real-time messages can be sent in the middle of other 
messages); and exclusive messages that use a manufacturer's identifi- 
cation code to identify a specific device the message applies to. 

MIDI instruments have 16 channel numbers available to separate 
messages into identifiable groups. A receiving device can be config- 
ured to accept input on the desired channels and route this data to its 
voices in different manners. 

From here on the indiscriminate use of the word "voice" can get 
very confusing, so let's clarify some terms. A voice is a sound gener- 
ator (the electronics that actually create a sound). Many modern syn- 
thesizers (including the lias) have multiple voices. A ctiannel is a MIDI 
term referring to one of the aforementioned 16 channels that MIDI 
can transfer data on. Sometimes the two terms are used inter- 
changably, but the correspondence is not always one-to-one. 

The overall way the transmitter — or in MIDI terms, the "mas- 
ter" — and receiver ("slave") interact with multiple channels is 
called a mode. Instruments may not have multiple voices to repro- 
duce multiple channels of MIDI voice information, so voices may be 
need to reallocated. There are two controllable attributes for voice 
and channel assignments: Omni and Mono. From combinations of 
these two attributes we arrive at four modes. 

One of the references I've looked at refers to the concept of 
mo,des as being confusing. This is an understatement. I've found at 
least three different descriptions of the attributes and one account 
saying that the definition of the Mono attribute has changed in recent 
history due to the influential implementation of a major manufacturer 
(Yamaha). Here's the way it seems to work, thinking of each from the 
viewpoint of the receiver. 

Enabling Omni allows reception of data on all channels; disabling it 
allows the reception only on one selected channel, called the basic 
cliannel. For most synthesizers, the default basic channel is 1, but 
any channel can be assigned as the basic channel. 

Enabling Mono causes the slave to use only one voice to play the 
data received; disabling it allows a different voice to be allocated to 
each channel according to the slave's internal voice mapping configu- 
ration. 

One description says the master and slave are operated in the 

same mode, but synthLab and a couple of other synthesizers I 
checked seemed to send out data on all channels regardless of the 
mode — the mode selection seemed to affect only input. 

This gives the four possible modes for the transmitter and receiver 
to operate in, based on the possible combinations of Omni on/off (for 
the channels recognized on reception) and Mono on/off (for the abili- 
ty to assign voices). 

Mode I (omni on, mono off) is referred to as "Omni" mode. A syn- 
thesizer in Omni mode will receive all channels and assign each chan- 
nel to a different voice. To make the channel-voice assignments you 
need to configure the receiver per its instruction manual. 

Mode 2 (omni on, mono on) isn't considered generally useful 



enough to warrant a generic name. In this mode, the Synthesizer lis- 
tens to all channels, but uses the messages to control only one voice. 

Mode 3 (omni off, mono off) is "Poly" mode. The synthesizer listens 
to only its basic channel and assigns incoming data to different voices 
polyphonically. You are probably wondering how a single channel can 
drive multiple voices; it turns out that among the types of MIDI mes- 
sages is one that allows a program (or patcti) ctiange, which many 
synthesizers interpret as an assignment to switch to a different voice. 

Mode 4 (omni off, mono on) is "Mono" mode. Here the slave listens 
to only the basic channel and plays incoming data on the correspond- 
ing voice (if the basic channel is changed, a different voice will be 
used). 

There's also a fifth "mode." It's created not by a change in the 
above possibilities but by the way some newer synthesizers can oper- 
ate. These synthesizers can receive on multiple channels using Omni 
mode and can also use program changes on each channel to desig- 
nate multiple voices. Such a synthesizer resembles several separate 
"Poly" mode synthesizers housed in a single unit. A synthesizer oper- 
ating in this fashion is referred to as operating in "Multi" mode. You 
may see this mode referred to in some MIDI software (including synth- 
Lab), 

Let's recap: there are four modes of which Mode 2 is seldom used 
so we can replace it with the fifth mode giving us four modes from 
five. Why would anyone find the common implementation of the MIDI 
specification confusing? 

That should get us far enough along to look at synthLab's use of 
these features. A basic IIqs and synthLab can be used as a playback 
device for synthLab songs with some control over the sound quality. 
Add a sound digitizer and you can create new sound files, making 
some adjustments with synthLab. Add a sound generation MIDI 
device and synthLab can play recorded sequences on the MIDI device 
as well as on the lies sound circuitry. Add a MIDI device that's a con- 
troller and it can be used to "play" the ligs through synthLab; in this 
configuration synthLab will also function as a multi-track recorder. 

Playing through the llgs. When you start synthLab (and click the 
arrow to go past the title screen) the first workscreen you see is the 
sequencer deck. The sequencer consists of positioning controls simi- 
lar to those of a tape deck (on the left side of the screen below the 
selection buttons) and track controls resembling a multi-track 
recorder (along the right half of the screen). 

The virtual tape deck implements the familiar record, stop, play, 
rewind, and fast forward buttons, and a less familiar "auto" rewind 
button that causes the sequencer to reset itself to the beginning of 
the current sequence when stopped. If you want to be able to stop 
and then resume playing from the point at which you stopped, make 
sure the "Auto" label within the button is not highlighted (click the 
button to toggle the setting). Below these controls is a speed adjust- 
ment control that is defined in terms of beats per minute ("BPM"). The 
two arrows to the right of this indicator adjust the current setting (the 
default is loaded as part of a sequence file). 

The MIDI Synth equivalent of a "song" is the sequence. The 
sequence itself is made up of MIDI codes organized as a function of 
time; the MIDI information determines when a note will be played, 
what instrument plays it, and so on (you can view the data for the cur- 
rently loaded sequence using the "View Sequence..." of the "Edit" 
menu). Sequences can be loaded (or saved) from the synthLab "File" 
menu. 

As we discussed in the August issue, the File menu can also be 
used to load waveforms into instruments and to load instruments 

themselves; this allows fine-tuning individual synthesizer compo- 
nents. When you load or save a sequence, these connected elements 
will be loaded or saved with it. Incidentally, in our August article we 
said we didn't know where the data format for MIDI Synth's records 
would be documented besides the MIDI Synth ERS; we now know this 
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information has been incorporated into Byte World's Frogrammer's 
Reference for System 6.0. 

In order to enable the use of MIDI with synthLab you need to select 
"MIDI..." under the "Setup" menu. This brings up a dialog box that 
lets you select the MIDI mode (among those discussed previously, 
synthLab supports the "Omni", "Poly", and "Multi" modes), whether 
you want to use MIDI input (letting synthLab receive information from 
another MIDI device) or output (telling synthLab to send MIDI data to 
another device) or both, the basic channel, and the Velocity compen- 
sation. The last element is one not discussed in the section on 
modes; the velocity compensation tells synthLab how much to react 
to any velocity component in the MIDI data; the larger the number, 
the more pronounced the reaction. 

The MIDI device 1 used to test synthLab was a consumer-level syn- 
thesizer, a Yamaha PSR-400 (about $300), which includes 100 voice 
programs, a 61-key keyboard with touch response, and many other 
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features. It has two MIDI receive modes, described as "Remote" 
(which seems to correspond to "Mono") and the more recognizable 
"Muld". Individual channels can be enabled or disabled for reception 
of messages and voice programs can be assigned output channels, so 
it fills most common requirements. 

With synthLab set to "Omni" mode, changing the "Instrument" caus- 
es the current basic channel to change to match, so if your keyboard 
seems to be "dead" when playing frorn synthLab, double-check the 
setup. Under Omni mode, changing the synthLab instrument results 
in the MIDI data from your keyboard being played as synthLab's set 
instrument even if the channel is changed. With the keyboard in 
"Remote" (again, nonstandard) mode, synthLab played any input data 
on the voice it was currently set to; with the keyboard in "MuM" mode 
synthLab assigned the MIDI data to program voice (piano). (I sus- 
pect this is because most of synthLab's included songs don't incorpo- 
rate program changes, and synthLab has no way to add them.) 

With synthLab in "Poly" mode, when the keyboard is played only 
the data being sent out on the voice channel matching synthLab's 
selected basic channel will be played. 

With synthLab in "Multi" mode the IIqs will play each channel on 
the associated instrument. That is, if synthLab's instrument number 2 
is a clarinet sound then all the MIDI data received on voice channel 2 
will be played as a clarinet 

So maybe we're not too lost; everything seems consistent. 

The 'Sequencer..." item in synthLab's "Setup' menu lets you 
select aspects of how the synthLab sequencer will act. The set- 
tings allow you to pick which "clock" (actually a timing signal) synth- 
Lab will use — either its internal clock or one supplied over t^e MIDI 
port from an external source (the MIDI master consistently sends tim- 
ing commands to make sure all the MIDI devices can stay on the 
sante beat). 

There is a "metronome" you can enable that will produce a click on 
synthLab's speaker for you to synchronize your playing to; you can 
also select to have a "count off" occur before the sequencer actually 
starts playing (or recording). 

A "Key start" button allows you to have the sequencer start record- 
ing at the first MIDI keypress. You can also select the number of beats 
per measure and the synchronization interval ("Beat to") for adjust- 



ments. 

Host of the rest of the "Setup" items are straightforward. The 

"Track output..." item lets you select whether each of the 8 
sequencer tracks will be sent to the Has speaker to play, to the MIDI 
bus, or both. Think of each sequencer track as a single tape recorder; 
the sequencer consists of eight tape recorders (actually "MIDI mes- 
sage recorders") all synchronized. 

"System controls..." include the master tuning of the synthLab voic- 
es, the volume of the "local keyboard" (synthLab's instrument voices), 
and the octave range transposition (you can transpose the synthLab 
voices up or down an octave if you think the tune will sound better at 
a higher or lower pitch). 

"Volume..." lets you select the output volume for each of synth- 
Lab's sixteen possible instruments, as well as the overall system vol- 
ume (this adjustment is used in conjunction with the IIqs speaker vol- 
ume you normally have set in the Control Panel). 

Using the sequencer "deck" generally parallels using a multi- 
track recorder. If you aren't used to the concept multi-track 
recorders allow you to select the individual recording channels 
("tracks") for either playback or record as the recorder operates. Real 
multi-track recorders can vary from a couple to 32 or more tracks. 
Most professional recording studios use 24- or 32-track recorders, 
though some purists regard this as overkill. Most home hobbiest units 
support 4- or 8-tracks. 

Incidentally, when we say "track" we mean a monaural (non-stereo) 
track; to create stereo you assign multiple tracks to record the sound 
from different spatial locations (real or simulated). Since the synthLab 
sequencer doesn't actually emulate a stereo mixer we'll skip over this 
complication. 

The controls for the eight tracks are arranged in four columns on 
the right side of the synthLab sequencer display. The first column is 
the "Channel" for each track; this determines what MIDI channel will 
be assigned to that track. The fourth column contains label areas 
where comments can be typed. 

The second and third columns contain the "Play" and "Record" but- 
tons that determine if the track is to be used for play back or for 
recording new information. The practical way to use multi-tracking is 
to record a few tracks (as many as you can competently master at 
once) with at least part of your music, leaving the "extra" tracks to 
add more embellishments later When you get ready to add parts, you 
can set the previously recorded tracks to "Play" and select unused 
tracks (or tracks you're ready to discard) to record the new additions. 
By working this way, a single person can add several instruments and 
sound like many people playing in concert. 

Only one track can be recorded at a time in synthLab, though you 
can play back any or all of the tracks. I experimented with recording 
tracks with the Yamaha synth with synthLab in "Multi" mode, record- 
ing one track, then playing a new instrument (selected by using the 
MIDI channel selection to switch to a corresponding synthLab instru- 
ment voice). 

The complete home studio. "Complete" may be too optimistic a 
word; music technology is changing about as fast as computer tech- 
nology now that they are somewhat interrelated, but starting with the 
IIqs you already have the core of a MIDI music studio. 

The Ifcs already qualifies as a MIDI sound source using the built-in 
Ensoniq synthesizer It also works as a MIDI controller to control the 
sound source, even serving as a sequencer since it can remember 
and store sequences of MIDI instructions. At least, this becomes true 
with synthLab now being distributed as part of system software. 

Three items are needed to make the IIqs a true musical instrument. 
One is an interactive MIDI controller (such as a keyboard) to allow 
entering data in real time; synthLab doesn't have a way to enter musi- 
cal data (though it can save and retrieve the data once it's available). 
That means you need a MIDI interface to connect the IIqs and the 
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interactive MIDI controller. Finally, although the Has has an internal 

speaker, you really need an external speaker of some quality. This 
can be a relatively inexpensive extension speaker with a small amplifi- 
er such as those used with personal stereos or it can be a high-fidelity 
stereo system connected through a stereo card. But something other 
than the tinny IIqs speaker is strongly advised; making the Ensoniq 
use the internal speaker is like hooking a single LED to the IIqs video 
output. 

If you plan to disseminate songs as computer data then you have 
everything you need. If you'd like to let other people hear your songs 
without having to cart your studio equipment around with you you'll 
need some type of conventional recorder; most people would proba- 
bly settle on a reasonably good cassette deck, You can also buy a 
mixer to allow you to adjust volumes and balance while recording 
onto tape, but from there we'll leave you to the services of a good 
audio consultant. If you plan do use the IIqs to augment a home stu- 
dio based on musical instruments, you probably should talk to some- 
one at a good professional music store. 

synthLab also wasn't meant to displace commercial programs, but 
it is a good place to start experimenting. For more detailed informa- 
tion, one company you may want to contact is Sound Management, 
Electronic Music Products, P.O. Box 3053, Peabody, Mass. 01961, 
508-531-6192 or 800-548-4907, which provides product sales and 
advice on computer music products and MIDI interfacing. 

Apple Writer: A guided tour 

by Ron Evry 

Granted, AppleWorks is the overwhelming favorite Apple II word 
processor today. But Apple Writer was the number 1 word processor 
before that. Even today it has an enthusiastic following and it has fea- 
tures found in no other Apple II word processors. 

In July, Appte Writer's author, Paul LutuS, agreed to let the Apple II 
RoundTable on QEnie distribute the software as freeware. This was 
the first major hit of the RoundTable's "Lost Classics" effort, which is 
the brainchild of Tim Tobin, the RoundTable's librarian. 

Since Apple Writer now has a very attractive price, it seems sensi- 
ble to share some knowledge about Apple Writer's operation and 
capabilities. This series of articles will examine Apple Writer's fea- 
tures, giving tips and advice to those interested in learning what 
Apple Writer has to offer. 

Apple Writer was once the most popular software package 
made for the Apple II. And deservedly so. However, somewhere 
along the line Apple Computer decided to market AppleWorks exclu- 
sively and took Apple Writer off the market. The fact that Paul Lutus 
has released Apple Writer as freeware means that a very, very power- 
ful tool has been made available free to every Apple II user Its basic 
word processing functions are so simple to learn that anybody can be 
running it in about five minutes. But it has a host of other built in fea- 
tures designed to accomplish many tasks, and best of all, it has two 
very powerful programming functions that enable anybody to fully 
customize the program. 

One of these functions is a built in programming language 
called WPL ("Word Processing Language"). WPL is remarkably 
compact, having only fourteen basic commands and an additional 
twenty-one "printer* commands. These enable a user to perform any 
number of complex functions. WPL programs exist to do mail merge, 
count the number of words in a document, read a series of files on a 
disk and pull out desired information from them into a new file, dis- 
play text material to students and then quiz them on it while keeping 
and saving the score, and an assortment of other tasks, These are lim- 
ited only by the user's imagination. 

The other powerful tool available to Apple Writer users is the 
built in glossary function. Similar to the Time-Out UltraMacros pro- 
gram for AppleWorks, Apple Writer's glossary enables the user to 



enter and save a series of keystrokes, which can include Apple Writer 
commands, and execute them. These keystrokes can be as simple as 
a frequently used word or as complex as commands that execute a 
series of WPL programs, one after another, at the press of a button. 

not only can glossary entries call up WPL programs, but entries can 
be nested into each other up to eight deep. They can be used to sim- 
plify insertion of imbedded printer commands (a glossary called Spe- 
cial comes with the Apple Writer disk, which contains printer codes 
for the ImageWriter), or perform mathematical functions like a pop^up 
calculator Different glossaries can be called up as needed, or a start- 
up WPL program can be put on a disk to automatically load them. 

Besides Apple Writer's built in customizing features, there are 
a number of keyboard shortcuts available all of the time. Many 
of these are similar to AppleWorks commands, such as the Rnd func- 
tion, which enables the user to search for strings and replace or 
delete them, either singly or throughout a document. Split screens 
can be had with a single keystroke, enabling the user to work on two 
different parts of a document at the same time. Blocks of text can be 
deleted or copied easily and you can peek at a document on a disk 
without disrupting the file currently in memory. 

Extremely large files can be loaded in pieces directly off of a disk, 
and conversely, parts of a file can be saved to disk separately. Multi- 
ple files can be joined together into single text pieces. Custom- 
designed "help" screens can be created, disks can be formatted from 
within the program, and there is even a built in telecommunications 
module that will work with a modem. 

So how does one use Apple Writei? In this first installment we 
will try to explain how to get the program off and running in as short a 
time as possible. The next part will explain how to use some of the 
more complex built-in features, and then, if there's an interest in 
future installments, we can explore the use and making of glossaries 
and WPL programs. In addition to that, I'll provide the names of some 
people to contact for incredibly jazzy patches to Apple Writer. These 
enable you to use as much memory as your machine has for a docu- 
ment, to put custom characters and high resolution graphics in your 
printed output, and to produce better quality output on a LaserWriter 
than a Macintosh can! 

Assuming you have an Apple Writer disk already (if you have 
downloaded it and you want to be able to boot it, you'll need to add 
the file ProDOS to it), you should make a backup copy and store the 
original in a safe place. Of course if you do patch the heck out it and 
need to start over, you can always download it again off QEnie. 

If you have an Apple He or an Apple lie, you can boot the program 
right up. If you have an Apple IlQs.you will need to play with the pro- 
gram's machine code a little bit before you will be able to print your 
documents. The instructions for IIqs owners are at the end of this arti- 
cle. 

Okay, so you've booted up the program, and the first thing you see 
is a screen that gives the number of the version of Apple Writer you 
are using, a copyright notice and an instruction to press return. Please 
do so. The next thing you will see is a blank screen with a bar at the 
top. There are a bunch of letters and numbers displayed on the bar. 
Press the escape key once and the bar is replaced by tab markers. 
These can be changed by moving the cursor to the tab position you 
want (or where you want to get rid of a tab marker) and pressing con- 
TROL-T Then type "S" to set or "C" to clean Pressing "P" will eliminate 
all of your tabs, if you need to do so. Mext time around, we will show 
you how to make your tab settings permanent, if you so desire. 

Pressing the iiscape key a third time will totally remove the bar and 
tab line, giving you a completely blank screen to work with. Pressing 
ESCAPE once more puts you back to where you started. 

If you'd like to start writing a document from scratch, just go 
ahead. The computer is ready for you. You'll find that the cursor 
moves as fast as you can type, If you are a superbly fast typist you 
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may see an asterisk appear on the bar line just to left of that "Z". This 
is telling you that you're typing so fast that the computer is storing 
your keystrokes until they can be put on the screen. If you'd like to 
see this feature, hold down a key and let it repeat itself over and oven 
Then do the same thing with your delete key until you've gotten rid of 
all those letters you don't want. Motice how fast it all is? 

Remember you don't have to press the returm key at the end of 
every line. Apple Writer has a built in word-wrap feature that moves 
the cursor down to the next line by itself. Generally, you should only 
press RETURN at the end of a paragraph, to automatically move to the 
next line. 

Once you've started writing, you may have Occasion to move 
around the screen with your cursor, perhaps to make changes, 
or to read some part of the document not currently on your 
screen. The simplest way to move around, of course. Is to use the 
arrow keys. A faster way to move around is to hold down the Solid 
Apple/Optioii key and press the arrows. The left and right arrows will 
jump from word to word and the up and down arrows will jump twen- 
ty-two lines. To move all the way to the beginning of a document, 
hold down the Comtrol key and press "B" (either upper or lower case 
will work with control characters). To jump to the end, press Cohtrol- 
E. See how logical this all is? (By the way, if you're a confirmed Apple- 
works user and you'd like to use the Opeh Apple key instead of the 
Control key, this can be arranged easily through the use of glos- 
saries. More about that next time around). 

If you need to make changes in your document, there are a num- 
ber of ways to do this. The simplest way is to position your cursor to 
the right of the characters you'd like to get rid of and press the delete 
key as many times as you need to. This technique can be time con- 
suming if you have lots of words, sentences or paragraphs to delete, 
so there are some keyboard shortcuts available to you. 

To get rid of words, move your cursor to the right of the first word 
you need to delete. Then look up at the arrow type character on the 
extreme left of the top bar It should be pointed to the left. If it is not, 
then press Comtrol-d to change its direction. You will notice that 
CoNTROL-D is a "toggle" key. You can push it over and over and it will 
change the direction of the arrow character back and forth. Next, 
press ConTROL-w ("W" for "word") and it will delete an entire word. You 
can repeat this word after word, until you've eliminated whatever you 
like. Mow suppose you eliminated too many words. You'd like to get 
them back, right? Just change the arrow direction with Control-d to 
point to the right and press ConTROL-w until you've gotten back the 
words you want. This feature is handy for moving words around in a 
document. Simply delete them from one place, move your cursor 
someplace else, and put them back. 

This feature is not limited to single words. Pressing CortTROL-x will 
do the same thing to paragraphs, grabbing everything up to the next 
carriage return. There is a limit of 1,024 characters in the text buffer 
area, so be careful about using it for very large blocks of text. Any- 
thing larger than that will push the first characters out of the buffer 
for good. If you really have a need to manipulate very large blocks of 
text, there is another way of doing it that uses the disk as a buffer 
More on that next time. 

Sometimes, you may want to simply type over words and change 
the text without deleting it first. Apple Writer has an overstrike fea- 
ture that will do this for you. Just press coriTROL-R to toggle the 
"replace* mode and you may then type directly over characters you 
need to change. When you wish to leave the "replace" mode, press 
coNTROL-R again. An "R" will appear on the top bar just to the left of 
the "Z" while you are in that mode. 

Eventually you will want to print your work. Ninety per cent 
of the dot-matrix and daisy-wheel printers in existence should 
work with Apple Writer "out of the box." To print your file, make 
sure that your printer is on and properly connected to your computer 
Then press comtrol-p. When you see the prompt that says "(Pjrint/Pro- 



gram:", type "flP" and return and watch the paper fly. 

If your print-out Is skipping lines, then you will need to tell Apple 
Writer not to send line feeds to your printer To do this, press con- 
TROL-p, then type "LIO" and return. This sets your line feeds to zero, 
next time around, we will show you how to make this setting perma- 
nent and also explore the various print formatting options available 
to you. If you're curious and would like to play around with these 
options in the meantime, press control-p, type in a question mark and 
press RETURN. You will see the array of pre-set Print commands dis- 
played. Have fun, and remember that you can always reboot and get 
back the default values. 

If your printer is some very obscure machine that won't work at all, 
there are some adjustments that you can make. Some time or other 
in the future, we can explore that topic, if there is a need to do so. 

A unique feature of Apple Writer is that the program is 
entirely memory resident. What this means to the user is that once 
it is loaded into the computer the Apple Writer disk can be removed 
from the drive (except to access the "help" screens and the WPL pro- 
grams and glossaries on the disk). Apple II users with one disk drive 
will find this very handy, as the need for constant disk swapping and 
flipping required for programs like AppleWorks is not necessary. 

You will need data disks to save your documents on. It helps to 
have some ProDOS formatted blank disks on hand, inasmuch as the 
Applewriter disk has very little space on it to store files. If you have 
just typed a document and found that you have no data disks on 
hand, you can format one from within AppleWriter. 

First of all, press control-o to bring up your Options screen. Press 
"\" ("Format Volume") and at the prompts tell Apple Writer what slot 
and drive numbers your blank disk is in. Be careful that you have 
removed Apple Writer from that drive or you will erase everything on 
the disk permanently! A typical 5.25 disk drive is in slot 6, drive 1. 
You will need to name your volume at the prompt, and you will be 
given a chance to back out at the last moment, just for safety's sake. 

If you have an Apple Ilos and you have patched Apple Writer , you 
may find that the formatting option does not work, so be prepared 
with some blank media. In a pinch, you can save your work to /RAM5, 
exit the program and format a disk. If you have a hard drive, you 
ought to have room for your file. 

Once you have a blank disk, you may save your file in a variety of 
ways. By pressing control-o, you can press "H" and set your prefix 
volume to the name of your data disk at the prompt. You must use 
ProDOS protocol in writing your volume name here (ex: /MY.DATA, not 
MY.DATA). Once you have done this, then you will have an easier time 
saving and loading files to that particular disk. 

When you are ready to save your file, you just press control-s (for 
"save") and type the name you wish to give your document. If you are 
writing a long document, you may wish to save it to disk every once 
in awhile as you are writing it, in case the electric company decides to 
shut down your power while you are working, or some other silly 
thing like that happens. 

After the first time you save your file, the top bar will display the 
name you saved it under The next time you press control-s, the 
name of your file will be displayed for you at the prompt. Unless you 
need to save it under a different name, hold down the right arrow key 
until you have gone past the filename, then press return. You will be 
asked if you wish to delete the old version of the file that is on the 
disk. This simply means that you are replacing what you have saved 
before with what you are saving now. If you do not want to do this, 
press "N" to go back and save it under a different file name. 

If you wish to save a file on a disk that is not the set prefix volume, 
you must use the complete ProDOS file name (ex: /MY. DATA/LET- 
TER. I). You may include existing subdirectories if you wish (ex: 
/MY.DATA/LETTERS/LEnER.1), and if you'd like, you can use the 
Options menu (comtrol-o) to create a subdirectory. If you are typing in 
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a complete filename, typing "./" will do for the volume that is already 
set or will accept whatever volume has been put in that drive. 

Once you have saved your file, you can clear it from memory by 
pressing cohtrol-m (for "New'). You will be ashed if you wish to delete 
the file from memory, just to prevent you from accidentally erasing 
something you have not saved to disk. 

Loading a file from a disk is very much the same process as saving 
a file. You press comtrol-l (for "Load") and type in the name of the file 
you wish to put into memory. The same rules apply about pathnames 
and preset prefixes. The only difference here is that you may need to 
find out the names of the files you can load. There are different ways 
to do this as well. 

If you have preset the volume prefix of your data disk, then press 
coriTROL-L, then a question mark, then press return. You will be given a 
catalog of available files and a prompt for the name of the one you 
wish to load. Another option is to press Cohtrol-o, and at the Options 
menu, select "A" ("Catafog"). Here you may press REiuRn to catalog a 
pre-set volume prefix, or type in a full path name. If you do not know 
the names of your on-line volumes, select option "F" first ("List Vol- 
umes On-Line"), then type in the path name. 

You may wish to leave Apple Writer at some time. To quit 
into FroDOS, press cofiTROi-Q, and from the Additional Functions 
Menu, press "J" ("Quit Apple Writef). You will be asked if you wish to 
lose memory contents, just in case you forgot to save your work first. 

This information should be enough to get you started with Apple 
Writer, flext time, we will explore many of the unique features that 
make this program so versatile. Until then, have fun using and explor- 
ing Apple Writer. 

As I promised, here are Don Lancaster's patches for enabling your 
Apple IlQS to print with Apple Writer. First, Lancaster recommends 
using a Super Serial Card in your IIqs rather than these patches if at 
all possible. If you can't do that, here's the patch information: 

FileffonB! WiSiSilM, i$OC 
',pple Writer v2.1 



Offset from begickg of file 


Old Vske 


Chiiige to 


$2DC] 


$10 


$60 


$2F7E 


$01 


$10 


$2F85 


$31 


$13 


Ipple Writer v2.0 






Offset from begistiig of file 


Old V.:liie 


Cktge to 


$2DB0 


$10 


$60 


S2F67 


$01 


$10 


$2F6E 


$31 


$13 



For those of you who don't know how to do a patch with this infor- 
mation, we've included a program on this month's A2-Central-on- 
Disk that will make the patch to v2. 1 for yau. The program is also 
available online in our library on QEnie. It's called AW.PATCH.BXY. 

Miscellanea 

Not too long ago, we received a copy of Cecil Fretwell's new 
UlttaCM tn the mail. I've found it real handy for cataloging our back 
issues. And if we ever start any Macintosh-based disk publications, I'll 
use it to catalog them as well since it reads HFS and DOS 3.3 disks as 
well. One thing that distinguishes this utility from others is the fad 
that it translates file types to English. UttraCat also provides a detailed 
summary of disk information such as, space used, space available, 
the number of standard and of hidden files, directories, and even 
how much memory UltraCat used to analyze all this information. 
There's a unlqtje way to seafch for 'lost" files called masking. Ultra- 
Cat is an Apple IIqs application and comes complete with a very read- 
able manual for $25.00. For further information write to Cecil 
Fretwell, 2605 Highview Avenue, Waterioo, lA 50702, 

I've got GEnie's Tim Tobin on the phone right now with an 



area code correction. His correct phone number is 310-813-5697. 
We printed it wrong on page 8.63 in the September issue. He also 
reports that the next Lost Classic to come to the surface is Don 
Thompson's WPL Extension Kit for Apple Writer 2. 1 . 

Game lovers have a few things to look forward to in the not- 
so-distant future. I couldn't tear my daughter Jamie away from Pro- 
cyon's booth at the Apple Central Expo. The reason? A game that 
they are marketing called PicK 'n Pile. It's one of those addictively 
obsessive little arcade game that could just get you fired if you were 
so careless as to install it on your hard drive at work. (Quip) For fur- 
ther information cont-i-act Procyon, Inc., P.O. Box 620334, Littleton, 
Co. 80162-0334, 303-993-4649. 

My son Eric was intrigued with Dreamworld's (P.O. Box 830, Iowa 
City, Iowa 52244-0830) upcoming TimeLord by Chris McKinsey as 
well as Interplay's (3710 S. Susan, Santa Ana, Calif. 92704, 714-545- 
900 1 ) Out of this World. He was able to snag a demo of TimeLord, 
which should be out sometime this fall. It's an Ultima-style game with 
incredible graphics and sound. Out of this World is already out for 
MS-DOS machines with a version for the Super Mintendo not far 
behind. And thanks to Bill Heineman's love of the Apple IIqs, we're 
going to get it too. 

The library of QEnie'S Apple 11 Roundtable has demo versions of 
Picli 'n Pile (file #19264) and TimeLord (file #19244) ready for the 
download. There is also a small file (#19276) that fixes a tiny bug in 
the PNP demo. Enjoy. 

Seven Hills (2310 Oxford Road Tallahassee, Fla 32304-3930, 
904-575-0566) is a prolific company. They've just introduced a 
new utility called l\angaroo. Appropriately. I^angaroo allows you to 
hop from one folder to another. It remembers where it has been, 
which makes accessing things faster than ever. Kangaroo also pro- 
vides the ability to perform many functions from within the applica- 
tion you are using. You can perform quick file searches, change file- 
types, delete files, rename files— well, you get the idea. 

Did you know that there is a hidden feature in AppleWorks 
GS 1.1 that allows you to access font sizes larger than 48k? 
Simply hit the oPTion-SHirr combination while in the Choose font sub- 
menu. This tip is especially useful to access the larger sized True- 
Type fonts available with Pointless. And while we're on the subject of 
Pointless, to figure out which version you have, double-click on the 
Pointless icon in your control panel, then press coniROL-oPEn apple-a. 
You'll see "Pointless 1.0 Revision 1", if you have the update installed. 

As vendors of Apple II software dwindle, local user groups 
become more and more important. I'm interested in knowing the 
status of our users groups, both nationally and internationally. Mow 
have they changed? How has the composition of your membership 
shifted through the years? What sort of meetings or membership cam- 
paigns have worked and what hasn't? We'd like to hear from you on 
this issue, It's an important one that needs addressing. Perhaps if we 
can share our successes and our frustrations, we can find a way to 
meet the needs of a changing and challenging computing environ- 
ment. 

If Morgan Davis had been present at the A2-Central Summer 
Conference, Jay Jennings coufd have used Davis' new product, 
fiADE instead of the multiple cans of bug spray that provided sight 
gag after sight gag at the Roger Wagner roast. RADE is a Real-time 
Applesoft debugging environment with powerful features such as 
breakpoints, variable watching, program flow tracing, single state- 
ment stepping, variable modification, online help, and debugging his- 
tory available from within applications. It is compatible with amper- 
sand extensions and MD-BASIC programs. It requires an Apple llos 
and retails for $49.95. For further information contact The Morgan 
Davis Group (sounds like a jazz quartet, don't you think?) at 10079 
nuerto Lane, Rancho San Diego, CaliL 619-670.0563, fax 619-670- 
9643.— edr 
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Mixed reviews 

1 found the article "How to be an Apple II 
Programmer" by Matt Deatherage in the 
September issue of A2-Central to be one of 
the most worthless articles I have ever read on 
computer programming. Although the article is 
almost four pages long, the little useful infor- 
mation contained within it would easily have fit 
within a single page. How many of you who 
read this article feel you learned anything signif- 
icant about programming your Apple It from 
this article? 

Even the little useful information contained 
within this article was sometimes misleading. 
The part of the article that disturbed me per- 
sonally was the tiny section which begins "next 
you need a development environment if you 
don't have one." This topic is so important to 
software development that there should have 
been mucli more than the very small discus- 
sion we got. In this section, Deatherage makes 
the statement, "If you program your Apple IIqs 
in Pascal and C and then goes on to plug 
products from ByteWorks. The only other 
language he specifically discusses in thisi sec- 
tion is assembly language. Why is he so vague 
on other languages? What's behind the omis- 
sions? 

In this letter, I'll ask the question Matt 
Deatherage refused to ask. What if you don't 
wish to program your Apple Has in Pascal, C, or 
assembly language? What if you wish to pro- 
gram in the easiest to learn of all the comput- 
ing^, languages, BASIC? This question would 
probably interest most of you who wish to pro- 
gram on the Apple IIqs because most of you 
were introduced to computer programming on 
your Apple 11 by Applesoft. Would most of you 
choose to learn a completely new computer 
language when, what you want to do can be 
done with a computer language with which 
you're already familiar? If you have an interest 
in BASIC and wish to go beyond Applesoft, the 
obvious choice is Micol Advanced BASIC for the 
Apple IIqs from Micol Systems; the only serious 
Apple llQS BASIC currently supported. 

Deatherage cannot claim ignorance about 
the Apple IIqs version of Micol Advanced BASIC 
for the simple fact that 1 discussed Micol 
Advanced BASIC with him at Apple Computer 
several years ago when we met there. We were 
present at KansasFest last year; A2-Central 
made an announcement about Micol Advanced 
BASIC version 4.0's release earlier this year and 



it has been continuously offered in their cata- 
log. 

If Mr. Deatherage had any interest in any lan- 
guages other than Pascal, C or assembly, he 
could have called us; we are very easy to reach. 
He would have found out that not only are we 
still selling Micol Advanced BASIC, we are still 
very actively supporting it. For example, version 
4.2 of Micol Advanced BASIC for the Apple IIqs 
is currently in beta testing and will be released 
shortly. 

When he discussed the 8 bit Apple 11 com- 
puters, the Apple lie and the Apple lie, the only 
products he specifically mentions are assem- 
blers. Beyond this he only makes general state- 
ments. How many of you who program on the 
Apple lie or lie program in assembly language? 
What about Micol Advanced BASIC for the 
Apple lie and IIc; the only higher level comput- 
er language for 8-bit computers still being sup- 
ported and promoted? On this topic, he is 
silent. By the time you read this letter, version 
4.5 of MicoJ Advanced BASIC for the Apple lie 
and lie will have been released. 

Another disturbing part of this article was 
when Deatherage compared ORCA/M with Mer- 
lin; he implies that ORCA/M is the more desir- 
able of the two products. Judging from the 
phone calls we receive here at Micol Systems, 
Meriin is preferred by people who program in 
assembly language. While Meriin is liked by 
almost all of the callers, ORCA/M has received a 
mixed reaction; some liked it, others don't. 1 
see no reason why these responses wouldn't be 
representative of what the Apple II market feels 
about the relative merits of each product. 

When 1 called Resource Central to complain 
about the above mentioned article, 1 was 
offered the possibility of writing an article on 
BASIC programming for an upcoming issue of 
A2-Central. normally, because 1 am busy 
improving and promoting Micol Advanced 
BASIC, 1 can't take the time for such things. 
However, because this article by Matt Deather- 
age says so very little about BASIC, 1 will make 
the time to write such an article if there is 
enough interest. If you wish to see and article 
about BASIC on the Apple II, please let A2- 
Central know. Mention what topics, in particu- 
lar, you'd like covered. I will do my best to be 
as informative and objective as possibte; some- 
thing 1 feel is lacking in Matt Deatherage's arti- 
cle. 

Stephen Brunier, President 
Micol Systems 
9 Lynch Road 
Willowdale, Ontario 
Canada M2J 2V6 

1 liked Matt Deatherage's article, "How to be 
an Apple 11 programmer," (A2-Central, Sept 
1992, pp 8.57-8.60). But what 1 would like to 
know is: Who's hiring?! 

After having and studying an Apple II Plus 
and an enhanced Apple lie for 15 years, 1 have 
become quite an expert on using and program- 
ming the 8-bit systems. 1 would like to make a 
career change and work for a company using 
my knowledge of Apples and ProDOS 8. The 
work could be full-time or part-time, using an 



employer's computer systems in their offices or 

on my Apple II system at home. 
So who is hiring? Would you publish or send 

me a list of companies interested in hiring 

expert (self-taught) Apple 11 programmers? 

James P Davis 
Hayward, Calif. 

As Matt indicated in his article, one of the 
best places for Apple 11 information is the 
online services. It's also a good place to intro- 
duce yourself to potential Apple II employers. 
If you don't already have a modem, get one 
and join GEnie or America Online. Become 
active, show off your knowledge, answer ques- 
tions intelligently. Write some freeware and 
malie sure it gets uploaded to the major 
boards. It's not a secret that this is exactly how 
the now-famous (and employed) Apple U 
celebrities like Andy nicholas and Jay Jennings 
got their starts. You never know.—edr 

Kfest kudos 

I attended my first KansasFest this year! How 
great it was! From the moment 1 arrived {at 10 
p.m. Monday), 1 could see that this event was 
going to run smoothly. And it did. The meals 
were fine and the accommodations entirely ade- 
quate. Events came off on schedule and, from 
outward appearances, without a hitch. But the 
best part of all was the people I met. Everyone 
was friendly and anxious to communicate. 
Understand that 1 am 63 years old and strictly 
an amateur programmer and hardly the one 
rushes to for advice in this group. I felt very 
comfortable. 1 particularly enjoyed talking to 
HangTime and Bo Monroe. I'm just sorry that I 
didn't have the opportunity to meet Tom 
Weishaar personally. 1 would especially like to 
thank Bo for all the time he spent with me 
(even at the airport) and for the insight he ren- 
dered. 1 knew of him only from my subscription 
to Script-Central— hut what a great guy. 

My thanks to you and your crew for putting 
on a highly professional conference and I look 
forward to seeing you all next year 

Woodruff Ogden 
Walnut Creek, Calif. 

More fax 

Regarding Peter van Dongen's letter in the 
July issue of A2-Central (AE fax problems), 1 
learned from some helpful person on QEnie (1 
wish 1 could remember the name) that the fax 
CDev need only be inactive during the boot 
time. After booting the system, you can go to 
the Finder, make the CDev active, and have 
access to the phone book and all th« tax soft- 
ware parameters as you are normally used to 
doing. Just remember to make it inactive when 
you are finished. 

Michael I^ickolas 
Lynn, Maine 
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What's the Plus in llc-Plus? 

Every one in a while, I hear about an Apple 
lie Plus. How does it differ from a regular 11c? Is 
the software compatible? 

Qeraldine Wright 
Hyattsville, MD 

Ms^or differemm in the two computers are 
OiM Oie He Plus Im a buHt4a 3.5 drive, raOier 
than a 5.25, it runs twice as fast and tfte 
power cord plugs directly into the computer, it 
doesn't have to run through a power "brick" 
first Software is compatible. The Apple lie Plus 
was released late in 1988 and is no longer sold 
by Apple. See our Fiovemtier 1988 newsletter 
for more information.— TW 



User group members wanted 

I was a Mibble subscriber and didn't know 
what 1 was missing. Received this first copy and 
can't wait for the next. 

I've just become president of the PenApple 
User Group in Redwood City, Calif, and seeK to 
attract new members. Our meetings are open to 
anyone who has interest in Apple 11 or Macin- 
tosh computers. 

William Lakner 
1399 Kentfleld Avenue 
Redwood City, Calif. 94061 
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Assorted queries 

A few short questions: 

The label from my nibble subscription said 
my subscription expired In 2-93. Why does your 
label say 1-93? 

Does anyone Imow where I can buy a sec- 
ondhand Apple llQs motherboard for my lie 
besides Shreve Systems and/or Pre-Owned Elec- 
tronics? i.e,< $350.00? 

I'm teo^j^ for booKs on interfacing my He to 
the outside world. Any ideas? 

Howard K. Jones 
Riverside, R.I. 

A few short answers: 

The expiration date on your rSbble label 
showed the first issue that you wouldn't 
receive and our label shows the last issue that 
you will receive if you don't renew. You haven't 
lost an issue, it's aff in the semantics. 

You m/ght want to try Shreve Sy^ems (3804 
Karen Drive, Bossier CUy, lA. 71 12, 800-227- 
3971) one more time. They are currently run- 
ning a special on the Apple lie motherboard 
upgrade. While supplies last, you may send 
them your Apple lie /qg/c board; they, in turn, 
will send you back a ffos bmrd, momted in 
the bottom of a He esse, for only $149. Catf for 
further details. 

Two books published by Vernier Software 
(2920 S.W. 89th Street Portland, Ore 97225, 
503-297-5317) will help you connect your 
Apple II to the outside world. The tides are 
Chaos in tbe Labmatmy and How to Bidid a 
Better Mousetrap, They can be ordered 
directly from the publisher or from us. And if 
this subject interests you, as it obviously does, 
don't miss Art Cousin's article "Science Pic- 
Son Ttrntre' in the April 1992 issue of A2- 
Cmtnd.—edr 
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Missing ianguage 



In your back issues you've mentioned lots of 
languages for the Apple U but I've never seen 
you mention ttyper^. This freeware program is 
highly compatible with Ansi C and the exam- 
ples in the K Sr R "C" reference. I have it in its 
entirety on a 3.5 dislt with full documentation, 
samples, conversion charts (from other "C" 
standards) and a hires library. I hope to put out 
some worthwhile 8-bit software with this magic. 
If anyone sends a SASE with 3.5 (preferably 
with goodies on it, but blank will do) to me, I 
will pass along a copy. 

Stephen Craft 
LPO 16068, P.O. Box 5064 
Hew Brunswick, M.J, 08903-5064 

QEnie subscribers might be interested to 
know that Hyper-C is also available in QEnie's 
A2Pro RoundTable Libraries (page 530, option 
3). The library also contains a patch (hie # 
191 7) to allow it to run on an Apple Has, the 
documentation (file #1741) and a file called 
l1C.MakeSys.bxy (file #2835) that makes sys- 
tem files using Hyper-C.— edr 
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